Hexamail Server Configuration Reference [POP3 Server]
[POP3 Server]
This config section holds settings for the POP3 Server module. This module listens for incoming connections and allows mail to be read by POP3 clients
The following settings can be used in this section:
Enable
You can turn on/off the entire POP3 Server module using this switch
bool
On/Off, True/False, Yes/No, 1/0
On
Enable=On
Host
the explicit network address or hostname of the network card you wish the server to bind to. Typically you will want to leave this blank to ensure binding to the default network device. Setting this to 127.0.0.1 can render it impossible to connect to the application
text
Host=127.0.0.1
Port
the port you wish the server to bind to. If you are using Hexamail Server as your main email server for your company email, you will typically want to leave this on the default setting of 110
number
110
Port=110
PortEnable
You can optionally enable this protocol
bool
On/Off, True/False, Yes/No, 1/0
true
PortEnable=true
MaxConnections
You can allow a large number of simultaneous connections to provide for large amounts of email users. Set this high if you have lots of users all wishing to connect simultaneously.
number
1 - 256
64
MaxConnections=32
SSLPort
You can allow POP3 access over SSL on a separate port. 995 is the default standard for SSL enabled POP3 and will work with most email clients.
number
110 - 32000
995
SSLPort=995
SSLHost
The host binding or NIC to use for SSL communications
text
SSLHost=127.0.0.1
SSLPortEnable
You can optionally enable this protocol over a secure channel using SSL. If you do not specify a certificate name using the SSLCertificate configuration parameter in the config file (.cfg) one will be created automatically for you. However, as this is an auto-created certificate it will not be signed by a certification authority and may cause warnings in the clients used to connect to this server. If the users of the clients accept the warnings, then SSL can be used immediately. If you do not wish users to see these warnings you need to obtain and install a valid, signed, SSL certificate for your server from a provider such as Thawte, or Verisign. You must then specify the certificate name in the SSLCertificate parameter of the configuration file.
bool
On/Off, True/False, Yes/No, 1/0
false
SSLPortEnable=false
SSLCertificate
WIN32: Choose a valid suitable certificate from those listed. If none are shown, then there are no suitable certificates installed on the server machine. You can install a certificate using IIS and then use that certificate from Hexamail. Certificates must be suitable for server authentication and secure channel encryption.
LINUX (OpenSSL): Specify the name/full path of a PEM certificate file valid for SSL server usage.
select
SSLPrivateKey
OpenSSL (LINUX) ONLY: You can optionally provide a separate private key PEM file. This must match the public key used of the certificate PEM file.
text
AutoLogoutTime
POP3 clients typically keep open a connection to the server for a few minutes. Therefore if you have a large number of users who all use POP3 you may want to decrease this timeout to ensure you do not exceed the maximum number of connections simpyl because a lot of user's email clients are open, but inactive.
30 minutes
AutoLogoutTime=15
TemporaryFolder
If the POP3 server has to make temporary files. It stores them in this directory
text
temp/pop3
TemporaryFolder=temp/pop3
Capabilities
Advanced setting of the capabilities response to the CAPA command for the pop3 server. In some special situations you may wish to manually configure the server capabilities list advertised to clients. This is sometimes useful for ensuring compatibility with clients who require specific strings.
Leaving this blank, the default setting, ensures the full list of the pop3 capabilities is advertised to clients and is usually most appropriate
text
DisallowedIPList
This is the list of disallowed IP addresses that will not be allowed to connect to your POP3 Server. You can use wildcards and ranges (e.g. 192.168.0.0/16, 192.*.*.*, 192.10-50.*.*) or leave blank for no restrictions. By setting this connections from any IP that matches an entry in this list are prevented.
Note that if an IP matches an entry in the allowed IP address it is allowed regardless of matching a disallowed IP
text
DisallowedIPList=62.235.23.32
Lock action
The POP3 protocol does not fully support multiple clients at once. In order to prevent synchronization issues it is usual
to lock any mailbox while POP3 access is in progress. This prevents mismatches between the lists of email sent to a client if another is deleting email at the same time.
However, some clients do not behave well if they are told the maildrop/mailbox is locked. These options allow you to report 0 messages instead of locking out other clients,
or to allow multiple clients to access at once. The last case is dangerous but can work if no clients are deleting email, and all clients leave all messages on the server.
text
Lock
Lock action=Lock
MaxRecvBandwidth
You can throttle the maximum bandwidth allowed for sending email clients to use when communicating with it. Typically you do not need to change this setting.
number
1 - 1000000 kbps
1000000 kbps
MaxRecvBandwidth=64
MaxSendBandwidth
You can throttle the maximum bandwidth allowed for sending responses to email clients. Typically you do not need to change this setting.
number
1 - 1000000 kbps
1000000 kbps
MaxSendBandwidth=64
DiagnosticLog
You can log the entire POP3 conversations to a log file for diagnostics/testing/issue resolution. The POP3 conversation is written to a log file in the logs directory called logs/pop3_username.log.
NOTE: POP3 diagnostic logging will affect performance.